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INIBODUCriON 


Virtual Terminals (VT) is a powerful enhancement to the standard 
multitasking capability of Multiuser Concurrent DOS (MC-DOS) allowing 8- 
and 16-bit users to enjoy the advantage of concurrency in a secure 
multiuser environment. With Virtual Terminals, up to four (4) different 
programs can share the screen and keyboard of a properly equipped serial 
terminal. The user can pick which program is currently attached to the 
actual screen and keyboard, and can switch instantly from program to 
program simply by pressing specially programmed function keys. 

Before Virtual Terminals, much of your computer's potential power 
was wasted. Consider this typical scenario: You are running a general 
ledger package and printing out a report that takes an hour. All other 
terminals on your system are busy. The phone rings, and a client 
requests critical information that you could easily retrieve from your 
database file... if oily you were not in the middle of your general 
ledger report. Your options are: call your customer back in an hour; 
bump some other user off of the system? abort the general ledger program 
and invoke your database manager, find the information, exit from the 
database manager, reload your general ledger package, and start your 
report again from the beginning. None of these alternatives is satisfactory 

With Virtual Terminals, you simply hit a key to switch to a 
different Virtual Terminal screen, invoke your database manager (which 
may already be loaded, ready to go), ask for the required information, 
and perhaps hit another key to switch instantly to a client billing 
program that is already loaded and waiting for input. All this could be 
going on while the general ledger package continues to grind away 
uninterrupted in the background. 

By eliminating the distracting and time consuming process of 
repeatedly loading and unloading programs, Virtual Terminal software 
maximizes your productivity and accuracy and minimizes your frustration. 

Your computer will become less like an adversary and more like a 
wonderfully powerful tool. 

Virtual Terminals can be used with any 8- or 16-bit program 
compatible with CP/M 2.2, CP/M-86, MP/M II, MP/M-86 or MC-DOS. Terminals 
supported include the TeleVideo 925 and 950, the QCS-80, the Freedom 200, 
the Qume QVT 108, or any multi-page terminal that emulates the TeleVideo 
950. You can even mix different types of terminals on one system. 
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USER'S GUIDE TO TEES MANUAL 


This manual is divided into three sections: 

1. Installing VT 

2. Using VT 

3. The KEYS Program 

The system manager should become familiar with all three sections. 

Users need only read Sections 2 and 3. 

Conventions 

Gifford Computer Systems has written this manual to conform to 

certain stylistic conventions for your reading convenience. They are as 

follows: 

1) System prompts and any messages that appear on your screen appear in 
boldface lettering, e.g. OA>. 

2) The status of any toggle switch is in UPPER CASE lettering, e.g. "The 
Status Line is OFF." 

3) System commands are in UPPER CASE lettering and are preceded by a 
system prompt, e.g. OA>VTTYS. 

4) Single keystroke commands are encased in parentheses, e.g. (A). 

5) File names and file types are in UPPER CASE lettering, e.g. VTTYS.SAM. 

6) References to any other sections of this manual are in boldface 
lettering, e.g. "Refer to page 12." 

7) References to any other manuals are in UPPER CASE lettering and 
underlined, e.g. "Refer to the MULTIUSER CONCURRENT DOS USER'S MANUAL. " 

8) When a caret C) appears before a character, press the Control key 
while typing that character. Thus, *C means to press the CTRL and C 
keys simultaneously. 

9) A question mark (?) in a file name is a "wildcard" character 
for which a specific numeral must actually be substituted. 
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SECTION ONE: INSTALUNG VIRTUAL TEEMENAIS 


snsooucnoN to section i 

SECTION 1 provides essential information can Virtual 
Terminals (VT) memory requirements and procedures for installing 
your VT software. This section also provides a brief explanation 
of the operation of VT and of the KEYS program and instructions 
for customizing your PASSWD file. We urge you to be patient and 
follow the instructions carefully, so that your VT software is 
customized precisely to accommodate your particular terminal and 
application needs. 
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SECTION ONE: INSmCZJNS VIRTUAL TERMINALS 


1.1 REQUIREMENTS 
System Requirements 

In order to run Virtual Terminals (VT), you must have the 
Gifford Multiuser Concurrent DOS operating system, and hardware 
that supports MC-DOS. 

System Memory Requirements 

Any program that is run on a Virtual Terminal requires the same 
amount of memory as it would if it were run on a standard terminal. 

For example, a single physical VT terminal equipped with four (4) 
pages of RAM and running four 8-bit programs concurrently would 
require 256K of RAM, the same amount of system memory as would be 
required by four standard terminals running those same programs. 

Terminal Requirements 

For a terminal to support Virtual Terminals, it must be able 
to use extra pages of screen memory, and must have supplementary 
RAM installed in the terminal itself. Terminals that can be adapted 
include the Freedom 200, the TeleVideo 925 and TeleVideo 950, the Qume 
QVT 108, and the GCS-80. The number of screens that can be attached 
to each terminal corresponds in most cases to the number of pages of 
memory that each terminal supports. For terminals currently supported 
by VT, the maximum number of pages is listed below: 

Terminal Maximum # of_ pages 

Freedom 200 4 

TeleVideo 950 4 

TeleVideo 925 2 

Qume QVT-108 2 

GCS-80 4* 

VT compatible terminals can be mixed together on the same 
system with standard, single page terminals. Also, different 
types of VT compatible terminals can be combined on the same system. 

* The GCS-80 can support up to 5 pages of display RAM, but Virtual 
Terminals oily supports 4 of these pages of display memory. 
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MULTIUSER CONCURRENT DOS SYSTEM DISK 


Your roaster system diskette, labelled MULTIUSER CONCURRENT 
DOS SYSTEM DISK, includes the following files: 


File name 


Description 


CCTMINIT.CMD 

VCMODE.CMD 


VFTYS.SAM 


Automatically reads the VITYS file at system 
startup, so that MC-DOS knows hew you have 
configured your Virtual Terminals. 

Specifies how MC-DOS treats screen output 
from background Virtual Terminals. 

Sample terminal initialization file 


KEYS.CMD 
VTQCS80.KEY 
VT950.KEY 


Utility for programming special function keys 
Sample function key template for GCS-80 terminal 
Sample function key template for TeleVideo 950 
or Freedom 200 terminals 


All of your other MC-DOS system files have been programmed 
to run in conjunction with Virtual Terminals software. 


If Gifford Computer Systems has installed your Virtual 
Terminals program for you, your system diskettes will have on 
them XIOS files appropriate for your system configuration. 


MULTIUSER OONCURRBir DOS XIOS DISK 

This disk contains the XIOS (extended input/output system) 
file options that are available to you, should you decide to 
reconfigure your system. If you decide to increase the number of 
physical or virtual terminals that your system supports, and 
either of the new values is greater than your current XIOS 
specifies, you must use the GENCCFM ccsrmand to reconfigure MC-DOS 
with an XIOS of larger capacity. The instructions for selecting an 
alternate XIOS file to accommodate any changes to your system 
configuration are documented in the manual entitled CUSTOMIZING 
YOUR MULTIUSER CONCURRENT DOS SYSTEM. 
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SECTION ONE: INSTALLING VIRTUAL TERMINALS 


1.2 INSEMUmON OVERVIEW 

The label of your MC-DOS master floppy diskette has the 
title MULTIUSER CONCURRENT DOS SYSTEM DISK. If you want to 
change your system configuration, choose a new XIOS file from the 
MULTIUSER CONCURRENT DOS XIOS FILES diskette to accommodate your 
new system configuration. You must use the WTYS.SAM file that 
is provided on your disk labelled MULTIUSER CONCURRENT DOS SYSTEM 
DISK to create a file called VTTYS. An additional program, 
KEYS.CMD, has been included on your master diskette for running 
Virtual Terminals. 

WHS 

The VTTYS file is an ASCII file, much like the TTYS file, 
that tells the VT kernel what terminals on your system can 
support VT and describes some technical characteristics of these 
terminals. A sample file, VTTYS .SAM, is included on your master 
system diskette. You can change this file with a text editor 
like WordStar so that reconfiguring your system is easy, but you 
cannot add more Virtual Terminal screens than are allowed by the 
XIOS cxi your diskette label. If you want to add more screens 
than the existing XIOS supports, you must choose a new XIOS and 
PIP it onto your master disk. 


KEYS.CMD 

The KEYS program allows you to program TeleVideo 950, 

Freedom 200, and GCS-80 function keys by creating template files 
which contain the character sequences that you wish each function 
key to send. These template files can be easily created and 
modified by an editor such as WordStar, and you can create large 
libraries of templates. 

Disabling Virtual Terminals 

If for any reason you want to disable the virtual terminals 
capability on your terminal, this can be done by entering a one 
(1) in field number 7 of your VTTYS file. After you do this, you 
must reboot your system in order to disable virtual terminals. 
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SECTION ONE: INHEMUNG VIRTUAL TERMINALS 


Hew Man/ Terminals are Supported by Your XIOS? 

The label of your system master diskette, marked MULTIUSER 
CONCURRENT DOS SYSTEM DISK, tells you how many physical terminals and 
virtual terminals your installed system can support. The number of 
physical terminals that can be supported is indicated by the third and 
fourth digits of the XIOS name that is printed on your master diskette 
label. The number of virtual terminals that can be supported is 
indicated by the fifth and sixth digits of the XIOS name. This is 
illustrated in the sample below: 

XIOS Type : X1070702 

AAAA 

Physical terminals supported = 07 

Extra VT screens supported = 07 

The example above indicates that this system supports a maximum 
of seven physical terminals and seven extra virtual terminal 
screens. Two things should be noted here. First, you do not 
actually need seven physical terminals connected to your system, 
nor do you even need enough serial ports to support that many 
terminals, for the number embedded in your XIOS name to be valid. 
Secondly, it is possible to select another XIOS from your 
diskette labelled MULTIUSER CONCURRENT DOS XIOS DISK. This is 
explained in the document CUSTOMIZING YOUR MULTIUSER CONCURRENT 
DOS SYSTEM. The technique that is described here will apply to 
any XIOS that you install. 

Counting the Number of Additional VT Screens 

If you are using a TeleVideo 950, Freedom 200, or GCS-80 
terminal, the maximum number of Virtual Terminals that each terminal 
can support is four (4), so the number of additional screens per 
terminal will vary, at your discretion, between one (1) and three (3). 

If you are using a TeleVideo 925 or a Qume QVT 108 terminal, the maximum 
number of Virtual Terminals that each terminal can support is two (2), 
so the maximum number of additional screens per terminal is one (1). 

To count the number of additional VT screens on your system, 
construct a table like the one on the next page, listing the 
terminals on your system and the number of pages of screen memory 
actually installed in each terminal and intended for use with VT. 
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SECTION ONE: INSTALLING VIRTUAL TERMINALS 


Table 1: Sample Terminal Configuration 
Terminal Number/Type Total Screen Pages Additional VT Screens 


(number from TTYS file) 

0: TeleVideo 950 4 3 

1: TeleVideo 925 2 1 

2: Adds Viewpoint 1 0 

3: Qume QVT-104 1 0 

4: Freedom 200* 4 2 

Additional VT screens: 6 


*In this example, only two of the Freedom 200's four pages 
of screen memory have been designated for use with VT. 

In the above example, the total number of additional VT 
screens is 6. This means that your XIQS must have at least a six 
in the "additional VT screens" field of its name. The best XIQS 
to select from your XIOS disk would have a "7" in this field, 
since you can either have 7 or 15, and 15 would be larger than 
you need, wasting space in RAM. Note that it is possible to mix 
terminals that support extra pages of internal RAM with ones that 
do not, aryl that it is not necessary to use all installed 
terminal RAM as extra VT screens. A modem is counted as a 
terminal, and if you attach a modem to a system that supports 
Virtual Terminals for that modem, someone who logs onto your 
system via that modem will be able to use Virtual Terminals, if 
the physical terminal from which they are calling your modem 
matches the terminal described in your VTTYS file. 

The last two digits in a XIOS name show the number of list 
devices (printers and plotters) in your system. Unless the 
number in the XIOS that you select matches the total number of 
printers and plotters attached to your system, you will either 
waste space in RAM (if the XIOS number is larger) or you will 
oily be able to use the printers or plotters whose device numbers 
in the LPRS file are smaller than the number of printers 
specified in the XIOS that you selected. 
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SECTION ONE: INSTMUNS VIRTUAL TERMINALS 


1.3 TEE VTTSS FILE 

The initialization and customization of your VT program is 
specified in the VTTYS file. The VTTYS file contains a series of 
lines, each of which describes one physical terminal intended for 
use as Virtual Terminals. Every physical terminal with 
additional screens must have an entry in the VTTYS file in order 
to be supported by VT. If the terminal does not have an entry in 
the VTTYS file, that terminal will be treated as a standard, 
single page terminal. The VTTYS file is automatically read by 
the OCPMINIT program during the boot sequence, and must reside on 
user area 0 of drive A: in order for VT to operate. 

Special Codes for the VTTYS File 

The VTTYS file is an ASCII file that can be created with the 
WordStar text editor in non-document mode. Since many of the 
fields in the VTTYS file require the ESCAPE character (Hex 
IB) and/or certain control characters, the VTTYS file supports a 
special coding convention by which non-printing characters may be 
entered and easily recognized by the user. The VTTYS file also 
supports codes for useful functions such as screen identification. 

VT interprets a slash (/) in the VTTYS file as the beginning 
of a special code sequence that indicates that the following 
character represents either a non-printing character or a special 
function. The list below describes these special code sequences. 

/ Indicates the beginning of a special code sequence. 

// Represents an ASCII slash character in the VTTYS file. 

/: Enables you to enter a colon in the VTTYS file without 
initiating another field. 

/to Causes a one (1) tick delay (l/60th of a second). This will 
cause a l/60th of a second delay if VT encounters it as part 
of a command string in fields 9, 10, 11, 12, 13, 14, or 15. 
This is important because seme terminals need a delay between 
the time that they receive a command string and the time that 
they switch screens. If the terminal needs more than l/60th 
of a second, embed more than one /D in the field. 
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SECTION ONE: INSEMUNG VIRTUAL TERMINALS 


/B Represents an ESCAPE (1BH) in the VTTYS. 

/V Represents an ASCII equivalent of the relative VT terminal 
number, starting at 0. This will always be a number between 0 
and 3. This can be useful in field 10 of the VTTYS file to 
switch to a specific VT screen. 

/v Represents an ASCII equivalent of the relative VT terminal 
number + 1. This will always be a number between 1 
and 4. This can be useful in field 15 of the VTTYS file to 
cause the status line to display the current VT screen. This 
option is provided because scxne users can become coif used when 
the first VT screen is numbered 0 instead of 1. 

/N Saids a line feed (OAH). 

/0 Sends a null character (OH), for a much briefer delay than /D. 

/0/0 Automatically updates the status line each time that you 
switch to a new virtual terminal screen. 

/* Followed by any character converts that character to a control 
character. Thus, /~K would be interpreted as Control K (^K). 

/ft Sends a carriage return (ODH). 

/C Indicates the logical terminal number which MC-DOS assigns 
to the current screen, i.e., the number which MC-DOS would 
return if you typed CONSOLE from the current screen. Should 
be a decimal number between 0 and 32. Every VT screen on the 
system has a unique logical terminal number. 

/P Indicates the physical terminal number as indicated in the 
TTYS file. Usually between 0 and 6. MC-DOS assigns every VT 
screen of the same physical terminal shares this number. 

/L Displays the current leadin character that you have 
established. 

/n Displays the current foreground terminal program name (without 
the file type) in the right-hand corner of your status line. 
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/p# A slash p, followed by a relative virtual terminals number, 
will display on the status line, the name of the program 
that is running on each of your virtual terminals. 

/e Displays on the status line, the '"P symbol, if the MC-DOS 
control character printer toggle is ON. 

/I Displays on the status line, the number of the printer or 
plotter to which you are connected. 

/s Displays on the status line the ~S symbol, which represents 
the characters used to stop the scrolling of a screen. 

/o Displays on the status line the symbol, which is the toggle 
used to "flush", or throw away, the characters that are output to 
background screens. The FLUSH option of the VCMODE program 
does not cause this symbol to be displayed. 

/m There are three arguments that can be used in conjunction with 
this VTTYS code to display the background screen output: 

"bufd," "dynm," and "fish," respectively corresponding to the 
BUFFERED, DYNAMIC, and FLUSH options of the VCMODE program. 

The VCMODE program a Hove you to dynamically select the way 
that characters are output from programs running on background 
virtual terminals. The effect of each of these three 
arguments is discussed in detail in Section 1.5. 
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SECTION ONE: INSTALLING VIRTUAL TERMINALS 


Hie 16 VTTYS Fields 

The VTTYS file is made up of sixteen (16) fields that are 

separated by colons. A description of these fields and their 

functions follows: 

1) Indicates the physical terminal number as it appears 

in the first field of the corresponding line of the TTYS 
file. This field allows you to identify to VT, the physical 
terminal that you are describing. If you move the physical 
terminal that you are describing to another I/O port on your 
system, this number will change and you must modify this 
field accordingly. 

2) Reserved for future use (RFU) by Gifford Computer Systems. 

3) RFU. 

4) RFU. 

5) RFU. 

6) Specifies the number of pages of memory available in your 
terminal. The kinds of terminals compatible with VT and the 
number of pages that they support is documented on page 2 of 
this manual. This field should contain a 2 for a 
TeleVideo 925, a 4 in the case of a TeleVideo 950 or 
Freedom 200, and a 5 for a QCS-80. 
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SECTION ONE: INSTALLING VIRTUAL TERMINALS 


7) Specifies the number of actual VTs that you want running on 
a specific terminal. For example, you can have four (4) 
pages of memory and support tally two (2) Virtual Terminals. 
This field can take on values between one (1) and four (4). 

If you enter a one (1) in this field, your terminal will not 
be affected by VT software. Any number that you enter that 
is higher than one (1) will give you that same number of 
screens for your terminal plus all of the other VT 
capabilities. The total number of system screens, combining 
both standard and VT screens, may be less than, but must not 
exceed the number for which the system was installed during 
the GENOCPM procedure. If more VT screens are requested than 
the system can accommodate, they will be ignored. 

8) Contains your "leadin'' character. The VT software looks for 
the leadin character to indicate that the subsequent 
character will be a command to change screens. You can 
select any leadin character that you wish. If you leave this 
field blank your leadin character will be a Control hyphen or 
Control underscore (Hex IF). For TeleVideo 925s, the leadin 
character should be a Control A (Hex 1), since the special 
function keys of the 925 always send a Control A as their 
first character. This would be entered in this field as: /‘"‘A. 

9) Contains the initialization sequence that is sent to the 
terminal when the system is first booted. This field can get 
fairly complex, and it is recommended that you study this 
manual's sample VTTYS entry for your specific terminal. If 
this field is left blank, no terminal initialization will 
take place. 


11 



SECTION ONE: INSTMLING VIRTUAL TERMINALS 


10) Contains the character sequence required by your terminal to 
switch directly to a specified screen. If your terminal has 
the capability of switching directly to a specified screen, 

as does a GCS-80, then this field should be filled, and fields 
11 and 12 should be left blank. If your terminal is unable 
to switch directly to a specified screen, but can only go up 
or down one screen at a time, this field must be left blank. 
In the case of the Freedom 200 and the TeleVideo 925 and 950, 
this field must be left blank. 

11) Contains the character sequence required by your terminal to 
cause an upward screen switch. For example, VT would use 
these characters to tell the terminal to switch upward from 
screen #2 to screen #3. For terminals which support direct 
screen switching and so have an entry in field 10, as in the 
case of the GCS-80, this field should be left blank. For the 
Freedom 200 and the TeleVideo 925 and 950, this field should 
have an ESCAPE K, which would be entered in this field as 
/EK. If you have a /0/0 embedded in this field, preceded by 
/EK, your status line will automatically reflect each time 
that you switch to a new virtual terminal screen. 

12) Contains the character sequence required by your terminal to 
cause a downward screen switch. For example, VT would use 
these characters to tell the terminal to switch downward from 
screen #2 to screen #1. For terminals that support direct 
screen switching and so have an entry in field 10, as in the 
case of the GCS-80, this field should be left blank. For the 
Freedom 200 and the TeleVideo 925 and 950, this field should 
have an ESCAPE J, which would be entered in this field as 
/EJ. If you have a /0/0 embedded in this field, preceded by 
/BJ, your status line will automatically reflect each time 
that you switch to a new virtual terminal screen. 

Note: If an entry is made only in field 11 or only in field 
12, VT assumes that the terminal's screen switching software 
will roll over, that is, in the upward direction go from 
screen 4 around to screen 0, or in the downward direction go 
from screen 0 around to screen 4. If your terminal supports 
both upward and downward screen switching, make the proper 
entries in both fields so that VT executes your screen switch 
as efficiently as possible. 


12 



SECTION ONE: INSCAIUNS VIRTUAL TEFMINMfl 


13) Contains the sequence of characters required by your terminal 
to turn ON the Status Line. This field should also contain 
the sequence of characters required to load text into the 
Status Line. For the Freedom 200, the GCS-80, and the 
TeleVideo 925 and 950, this field should have an ESCAPE g 
ESCAPE f ESCAPE G 4, which would be entered in this field as 
/Bg/Ef/EG4. 

14) Contains the sequence of characters needed to turn OFF the 
Status Line. For the Freedom 200, the GCS-80, and the 
TeleVideo 925 and 950, this field should have a carriage 
return which would be entered in this field as /ft. 

15) Describes the Status Line display. Whatever text that you 
want entered into the Status Line should be in this field. 

16) Caiment field. 

Examples of Virtual Terminals Comnand Strings 

The sample lines on the following pages can be used as a 
model to help you understand how the VTTYS file and its special 
codes work and to give you a head start in creating your own 
VTTYS file. Each entry is explained in some detail in order to 
give you an idea of how to use the special codes in the VTTYS 
file. The three sample lines analyzed below are contained on 
your master system diskette on a file called VTTYS .SAM. It is 
recommended that you borrow these lines intact for the initial 
creation of your VTTYS file, using one line for each VT terminal 
on your system, in each case selecting the line that matches your 
terminal, and modifying only field 1, which must correspond to 
the logical terminal number of each terminal as indicated in the 
corresponding entry of your TTYS file. The first sample command 
string is for a TeleVideo 950 or Freedom 200 terminal. The 
second sample is for a TeleVideo 925 and the third is for a GCS- 
80. Do not use a carriage return to break up lines that contain 
more than 80 characters— WordStar in non-document mode will 
allow you to enter lines of any length. 
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Semple Command String for a TeleVideo 950/Freedam 200: 

0:::: :4:4:/^j/^/E*/EJ/E*/EJ/S*/^/E*/E!J: :/EK/0/0:/EJ/0/0:/E^/Ef/EG4:/R: 

\\\\\\\ \ \ \ \ \ \ \ 

123456 7 8 9 10 11 12 13 14 

/pO/pl/p2/p3/L/e/s/o:TeleVideo 950 with 4 pages 

\ \ 

15 16 


Field # Explanation 

I Terminal number is zero (0), as indicated in the TTYS file. 

2-5 Reserved for future use by Gifford Computer Systems. 

6 This terminal has four (4) pages of memory. 

7 This terminal will support four (4) Virtual Terminals. 

8 VT will interpret a Control underscore C_) as the leadin 
character for this terminal. 

9 The initialization sequence that VT will send to the 
terminal is as follows: enable DTR handshake; clear 
screen; display previous screen; clear screen; display 
previous screen; clear screen; display previous screen; 
clear screen; and display previous screen. 

10 Since the TeleVideo 950 and Freedom 200 do not support 
arbitrary screen switching, this field is empty. VT will 
instead use the downward screen switch field and the upward 
screen switch field as appropriate. 

II VT will use this escape sequence to switch the screen 
upward, and automatically update your status line. 

12 VT will use this escape sequence to switch the screen 
downward, and automatically update your status line. 
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13 This field entry enables the Status Line to be turned ON; 
enables the Load Status Line; and enables the Status Line 
to be displayed in reverse video. 

14 This field entry disables the Load Status Line. 

15 The status line for this terminal will display the current 
process being run on each of the four virtual terminals, the 
current printer number, the 'T? connection to the printer 
toggle, the ~S stop scrolling toggle, and the ^0 throw away 
background character output toggle. 

16 This comment field reads "TeleVideo 950 with 4 pages." 
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Sanple Command String for TeleVideo 925: 

2:::::2:2:/"A:/^/E*/Eg/EJ/E*/Eg/BJ::/EK/0/0:/EJ/0/0:/Eg/Ef/EG4:/R: (cont) 

\\\\\\\ \ \ \ \ \ \ \ 

12345 6 7 8 9 10 11 12 13 14 

/pO|/pl|/p2|/p3|/printer=A/Virtual Terminal /vsTeleVideo 925 with 2 pages 

\ \ 

15 16 


Field # Explanation 

I Terminal number is two (2), as indicated in the TTYS file. 

2-5 Reserved for future use by Gifford Computer Systems. 

6 This terminal has two (2) pages of memory. 

7 This terminal will support two (2) Virtual Terminals. 

8 VT will interpret a Control A ( A A) as the leadin character 
for this terminal. Putting a Control A in this field allows 
you to take advantage of the fixed function keys of the 
TeleVideo 925, which always begin their transmissions with 
Control A. 

9 The initialization sequence that VT will send to the 
terminal is as follows: enable DTR handshake; clear screen; 
display Status Line; display previous screen; clear 
screen; display Status Line; display previous screen. 

10 Since the TeleVideo 925 does not support arbitrary screen 
switching, this field is empty. VT will instead use the 
downward screen switch field and the upward screen switch 
field as appropriate. 

II VT will send this escape sequence to change VT screens and 
automatically update your status line. 

12 VT will send this escape sequence to change VT screens and 
automatically update your status line. 
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13 This field entry enables the Status Line to be turned ON; 
enables the Load Status Line; enables the Status Line to be 
displayed in reverse video. 

14 This field entry disables the Load Status Line. 

15 The status line for this terminal will display the current 
process being run on each of the four virtual terminals, and 
will display a vertical bar between each of the processes, 
the letters "printer =" followed by the current printer 
number, and "Virtual Terminal" followed by the number of the 
virtual terminal in ASCII. 

16 This comment field reads "TeleVideo 925 with 2 pages." 
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Sample Command String for GCS-80: 

1:::: sS^i/^i/E.PS/E^/E.Pa/E^.Pl/E^/E.PO^i^A^/D/E.PA/G/D/lD 

\\\\\\\ \ \ \ 

12345 678 9 10 


: : :/Eg/Ef/BG4:/R:/pO/pl/p2/p3/n/m"fish":GCS-80 with 5 pages 

\ \ \ \ \ \ 

11 12 13 14 15 16 

Field # Explanation 

I Terminal number is one (1), as indicated in the TTYS file. 

2-5 Reserved for future use by Gifford Computer Systems. 

6 This terminal has five (5) pages of memory. 

7 This terminal will support four (4) Virtual Terminals. 

8 VT will interpret a Control underscore C_) as the leadin 
character for this terminal. 

9 The initialization sequence that VT will send to the 
terminal is as follows: go to screen #3; clear screen; go 
to screen #2; clear screen; go to screen #1; clear 
screen; go to screen #0; clear screen. 

10 For the GCS-80, the arbitrary screen switch has been enabled 
with the following specifications: three l/60th of a second 
delays; enable the terminal to change to the screen 
represented by an ASCII 0, 1, 2, or 3; and three more 
l/60th of a second delays. 

II Fbr this terminal, the upward screen switch field is empty. 
The arbitrary screen switch field has taken priority. 

12 For this terminal, the downward screen switch field is 

empty. The arbitrary screen switch field has taken priority. 


(cont.) 
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13 This field entry enables the Status Line to be turned ON; 
enables the user to load the Status Line with text; enables 
the Status Line to be displayed in reverse video. 

14 This field entry disables the Status Line. 

15 The status line for this terminal will display the current 
process being run on each of the four virtual terminals, 
the name of the current foreground program being run, the 
letters "fish" will be displayed indicating that the 
background character output is being thrown away. 

16 This comment field reads: "QCS-80 with 5 pages." 
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1.4 HOW TO USE VIRTUAL TERMINALS 


Direct Operation of VT Functions 

The VT kernel modifies your MC-DOS operating system so 
that certain character sequences are intercepted before they are 
passed through to an application program. These character 
sequences are introduced by the leadin character that you defined 
in field 8 of your VTTYS file. The leadin character tells the 
system that the subsequent character is an instruction to 
switch VT screens. Virtual Terminals supports the ability to 
switch directly to a specific VT screen. 

After you have established your leadin character in field 8 
of the VTTYS file, your options are as follows: 

Command Sequence Function 


1) leadin 0 
leadin 1 
leadin 2 
leadin 3 


switches to first VT screen, 
switches to second VT screen, 
switches to third VT screen, 
switches to fourth VP screen. 


leadin @(RETURN) same as 
leadin A (RETURN) same as 
leadin B(RETURN) same as 
leadin C (RETURN) same as 
(RETURN=carriage return) 


leadin 0. 
leadin 1. 
leadin 2. 
leadin 3. 
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Thus, if your leading character is a Control Underscore 
C _), you could switch directly to the third VT screen by typing: 

3 

If your application program uses control underscore for some 
dedicated purpose, you should change your leadin character to 
something that is not otherwise used. 

The leadin @, A, B, and C options are provided because the 
TeleVideo 925 has fixed function keys rather than programmable 
ones. Function key FI on a TeleVideo 925 sends a '"A @ (RETURN), 
F2 sends a "A A (RETURN), F3 sends a a AB (RETURN), and F4 sends 
a A AC (RETURN). If you wish to use the function keys on a 
TeleVideo 925 to switch VT screens, you must establish a Control 
A in your VTTYS file as your leadin character, but you must be 
aware that any time that you enter a Control A followed by an 
upper case A and a carriage return, you will switch to the first 
VT screen. 
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1.5 VOtODE 

The VCMODE program allows you to dynamically change 
certain background operating characteristics of your VT 
terminals. There are five arguments available with the VCMODE 
program. They are: 

VCMODE BUFFERED 
VCMODE SIZB=N 
VCMODE DYNAMIC 
VCMODE FLUSH 
VCMODE HELP 

If you invoke VCMODE without an argument, as in: 


QA>VCM0DE 


your screen will tell you the background mode for your 
current virtual terminal. If the background mode is set to 
BUFFERED, the program will tell you the maximum file size: 


Background Mode for Virtual Terminal 0 is buffered 
Maximum file size = 10K 


The HELP option of VCMODE allows you to extract information 
about the VCMODE program itself, including all of VCMODE's 
primary command arguments. If you type: 


QA>VCMODE HELP 


the terminal will display a general description of the VCMODE 
command. 
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The VCMODE program allows you to dynamically select the way 
that VT will handle characters that are output to background 
screens, i.e„ screens which you are not currently monitoring. 
VCMODE outputs characters to background screens in three 
different modes. 

The BUFFERED mode saves the first n kilobytes (n times 1024 
characters) that any application program attempts to output to a 
background screen and stores those characters in a temporary 
buffer area of your hard disk. You can specify the maximum size 
of the disk buffer file with the SIZE=n option of the VCMODE 
program. You must be in BUFFERED mode to use the SIZE option. 

You can cause the current VT screen to operate in BUFFERED 
mode by typing: 


0A>VCM0DE BUFFERED 


To set the maximum size of the disk buffer to 15K, type: 


QA>VCM0DE SIZE=15 


If you invoke a program and then switch your screen to 
another virtual terminal, up to 15K of background output (in this 
example) could be sent to the disk buffer. Once this RAM buffer 
fills up, your background program will pause as soon as it tries 
to send an additional character to the buffer. When you switch 
back to a BUFFERED virtual terminal that has sent screen output 
to the disk, any characters stored in the disk buffer are 
immediately sent to your screen, and the program resumes 
execution. The temporary buffer files are automatically erased 
from the disk after BUFFERED output is displayed to the screen. 
This is the default output mode of VT, and was created so that 
background programs whose screen output is critical can run as 
long as possible without losing characters. 
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In seme programming and technical applications, however, it 
is helpful to see output in real time from a background process. 
The DYNAMIC option allows you to monitor screen output as it is 
produced by a detached program, without concern that the 
background process will pause if your disk buffer becomes full. 
A background virtual terminal in DYNAMIC mode sends character 
output directly to the screen, rather than to a disk buffer. 

You can cause the current VT screen to operate in DYNAMIC 
mode by typing: 


QA>VCMODE DYNAMIC 

Background Mode for Virtual Terminal n set to Dynamic with Output 


If you invoke a program from a virtual terminal whose VCMODE 
status in "DYNAMIC mode with output," the character output will 
be displayed on screen, even if you switch to another virtual 
terminal. That is, even though your keyboard and screen are 
attached to a different foreground virtual terminal, a program 
running in the background on a DYNAMIC virtual terminal can still 
write to your physical screen. 

VCMODE also provides a PLUSH option to suppress screen 
output from a background virtual terminal. For example: 


5OVCM0DE FLUSH 

Background Mode for Virtual Terminal n set to Dynamic with Flushing 


With the FLUSH option, characters sent to the screen by a 
background process go neither to the screen nor to a disk buffer, 
but are discarded, and go nowhere. The FLUSH mode prevents a 
background virtual terminal from sending characters to the 
screen, even when you bring that virtual terminal back to the 
foreground. When you return to a virtual terminal that is 
operating in FLUSH mode, the screen will not display any output, 
but will only show what was on the screen previously. 
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1.6 THE KEYS PROGRAM 

It is convenient to use programmable function keys to switch 
VT screens, since you can then go from screen to screen with a 
single keystroke. Your master system diskette has a file on it 
called KEYSjCMD that allows you to program the function keys of a 
TeleVideo 950, a Freedom 200, or a QCS-80. The KEYS program 
simply executes a template file that you can create with WordStar 
in non-document mode. This template file contains a code for 
each prograninable key followed by the character sequence that you 
wish each key to generate. Since you specify the template file 
that you want to execute when you run the KEYS program, you can 
create an unlimited library of tenplates to match various 
applications. Since these template files can be created with any 
editor such as WordStar, they are extremely easy to generate and 
maintain. 

Several template files have been included on your MULTIUSER 
CONCURRENT DOS SYSTEM diskette that allow you to program function 
keys for use with the VT program. These templates all have the 
file type .KEY. For the TeleVideo 950 and Freedom 200 terminals, 
the VT950.KEY file that is on your master system diskette is 
written to program function keys one (1) through four (4) to 
switch directly to the first through fourth VT screens 
respectively. To program your TeleVideo 950 or Freedom 200 
function keys using this template, type: 


QA>KEYS VT950 


For the GCS-80 terminal, the VTQCS80JCEY file specifies the 
top four keys on your 18-key pad, left to right, to switch to VT 
screens one through four respectively. If you have a GCS-80 
terminal, you would program these function keys by typing: 


QA>KEYS VTQCS80 
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Both these .KEY templates use Control underscore C_) as the 
leadin character to switch screens, so if your VTTYS file 
specifies a different leadin character, these templates must be 
modified. 

Remember that the programmable function keys on all of the 
terminals mentioned are volatile, meaning that once power to the 
terminal is turned OFF, you must run the KEYS program again 
in order to reprogram your keys. This is an appropriate job for 
LOGIN .SUB and USERINIT. SUB. 

The KEYS program is described in detail in Section 3 of this 
manual. 


1.7 WARNINGS 

1) The WRITE utility now returns a warning if you attempt to 
send a message to a screen that is not being monitored. If 
this occurs, run the WHO progam which will display that 
user's current Virtual Terminal screen. 

2) If your VTTYS file has been set up to allocate four (4) 
Virtual Terminal screens to your terminal, make sure that 
when you are finished using your terminal, you log out of all 
four screens. If you fail to log out of a background screen, 
it will be possible for an unauthorized person to enable that 
screen and gain access to the system. 
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INTRODUCTKK TO SECTION 2 

This section assumes that your Virtual Terminals program has 
already been installed by your system manager. It is intended to 
provide the non-technical user of VT with enough information to 
take advantage of Virtual Terminals without having to become an 
expert in its installation and use. Before reading this section, 
you should read Chapter 1 and Chapter 2 of Gifford's MULTIUSER 
CONCURRENT DOS USER'S MANUAL. 
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2.1 THE VIRTUAL TERMINALS H9VERGKMENT 

Virtual Terminals give you the advantage of having more than 
one terminal available to help with your work without costing you 
extra money or desk space. To understand how to take advantage 
of Virtual Terminals, you should imagine that you actually do 
have several terminals before you. But instead of having 
multiple keyboards, which would not be of much use since you could 
only use one at a time, you have instead only what is useful: 
multiple screens. And though all the screens share the same 
glass tribe, you can switch from one screen to the other instantly 
as though you were changing channels on a television set. You 
can start a program running on one screen, switch to another 
screen to start another program, and so an until you run out of 
things to do or screens on which to do them. Different screens 
can even output to different printers, so you could have several 
programs printing documents or reports simultaneously. 

You will find as you grow accustomed to the idea of Virtual 
Terminals— the idea of multiple screens sharing a single 
keyboard— that your interaction with the computer will take on a 
qualitative change. Instead of operating your machine, you will 
manage it. Instead of hitting sane keys and waiting for results, 
you will orchestrate simultaneous tasks. Things you never tried 
because there are only so many hours in a day, you will begin to 
do routinely. You are likely to become more efficient, more 
productive, and more creative. You are bound to have more fun. 
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2.2 GEFFIN5 SIAKEED - A PRACTICE RUN 

The first thing you must find out about your Virtual 
Terminals (VT) installation is the number of screens that your 
terminal supports. Your system manager will have this 
information. The most screens possible for a single terminal are 
four, and, generally, the more the better. 

Logging In 

When you first sit down at a terminal running under VT you 
will notice only a slight difference, if any, between the screen 
display and a normal screen display. The only difference should 
be the status line, the 25th line at the bottom of your screen. 

If your system manager has installed this feature, the status 
line should have a display saying something like: 


Virtual Terminal 1 


It may contain other information, since this line can be 
customized, but it should at least tell you the Virtual Terminal 
screen number, i.e.. Whether you are currently looking at the 
first, second, third, or fourth screen of your terminal. When 
your system first boots, you should be looking at the first VT 
screen. 

Your screen should also display your usual MC-DOS sign-on 
message along with the login prompt. 


Name: 


You should log in to this screen the same way that you would 
log in to a standard MC-DOS terminal, giving an account name 
and a password. You can also run any program that you could 
normally run, such as WordStar, Super Calc, or dBASE II. Invoke 
some program with which you are familiar. 
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This is where the real difference begins between VT and 
standard MC-DOS. Ask your system manager whether the function 
keys on your terminal have been programmed to switch screens. In 
the case of a TeleVideo 925 or 950 or a Freedom 200, the F2 key 
at the top left part of the keyboard could be programmed to cause 
the terminal to switch to screen # 2. Press F2. (If F2 has 
not been programmed, press the CTRL and the underscore keys (*_) 
simultaneously, then the 2 key.) You should instantly see a 
fresh screen with the name prompt again. Also, the status line 
should now say: 


Virtual Terminal 2 


Again you must log in, though you can use a different valid 
account name if you like. You can also run any standard program 
oi this new screen. Invoke a program, and allow it to load. Now 
press either Fl or control underscore (*_), followed by a one (1). 
You should instantly be back looking at your original screen. 
Virtual Terminal #1. 

From the first screen, type: 


QA>WH0 -A 


You should see displayed both of the accounts which you opened. 
Notice that an asterisk (*) appears next to the terminal 
corresponding to the screen that you are currently monitoring. 

If other people are using the system, an asterisk will appear 
beside all of the account names whose screens are currently being 
monitored. 
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Lagging Out - Genserving M em ory 
Now type: 


OA>LOGOUT 


from screen #1. You should be back at the login prompt. Note 
that everything looks as though the system is back where it was 
before your session began. But remember there is still a program 
running in the background on screen #2. Though that program is 
probably simply waiting for input and so is not slowing down the 
system, it is nevertheless wasting at least 64K of memory. Which 
means that somebody on another VT screen may not be able to load 
a program. When you log out of a Virtual Terminals environment, 
log out of all VT screens, not just the current one. 

You have just been around the track once with Virtual 
Terminals and you now know about 90% of what is necessary to know 
about the Virtual Terminals software in order to use it 
productively. The rest of this section will deal with some of 
the finer details of Virtual Terminals. 

2.3 SWITCHING VT SCREENS 

Using the Leadin Character to Switch Screens 

You can cause VT to switch you to any screen by typing what is 
called the leadin character followed by the number of the screen, 

0 through 3, which you wish to monitor. The leadin character can 
be any character you select, though the default character is a 
Control underscore (~_), entered by depressing the CTRL and the 
underscore keys simultaneously. (This obscure character was 
selected as the default leadin character because outside of VT it 
is rarely used. If this is your first time with VT, there is a 
good chance that you have never before typed this character.) 
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The commands to switch directly to any screen are listed belcw: 

Virtual Screen Command Sequence 

first 
second 
third 
fourth 

= Control underscore 

If you are currently monitoring your first VT screen and you 
want to look at your third screen, you would enter: C_) 2. Note 
that the number you enter is one less than the number of the 
Virtual screen, since the screen switch command considers the 
first screen to be 0. 

Using Programmable Function Keys to Switch Screens 

Though it is possible to switch VT screens by using the 
above technique, it is not convenient. It is much faster and 
more accurate to use your terminal's special function keys to 
switch screens. All terminals known to support VT have a 
number of special function keys which may be used for just such 
a purpose. In the case of the TeleVideo 925 and 950, and the 
Freedom 200, the top row of keys are inscribed "FI”, "F2", "F3", 
and so on. The KEYS program allows you to program these special 
function keys so that when you press them they automatically send 
any characters that you desire. If you program them to send the 
VT leadin sequences listed above, you will be able to switch 
directly to any VT screen with a single keystroke. 

Run the KEYS program by typing the word KEYS, followed by 
the name of a template file. The template file contains the 
character sequences that you want the various function keys to send. 
SECTION 3 of this manual explains how to use the KEYS program and 
how to create and maintain template files. It is sufficient for 
now to know that your system has several templates already 
written that allow you to pregram your special function keys for 
use with Virtual Terminals. The summaries on the following pages 
list these templates by name and describe the function keys that 
they program to cause VT to switch screens. 
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VT950.KEY: KEYS template for TeleVideo 950 and Freedom 200 
Function Key Character Sequence VT Function 


FI 

r ) 

0 

F2 

r~) 

i 

F3 

r~) 

2 

F4 

r~) 

3 


Switch to first VT Screen 
Switch to second VT Screen 
Switch to third VT Screen 
Switch to fourth VT Screen 


VTGCS80.KEY: KEYS template for 
Function Key Character 


CDL MODE ("_) 
COPY BLOCK ("_) 
WRITE BLOCK C_) 
BLOCK DEL (* ) 


GCS80 terminal 

Sequence VT Function 

0 Switch to first VT Screen 

1 Switch to second VT Screen 

2 Switch to third VT Screen 

3 Switch to fourth VT Screen 


As an example, if you have a TeleVideo 950 or a Freedom 200 
terminal that has been upgraded with extra pages of internal RAM, 
the first thing you should do after logging in to a freshly 
booted system is type: 


QA>KEYS VT950 


After you enter the above line from your terminal, pressing 
key FI will switch you to the first VT screen, F2 to the second, 
F3 to the third, and F4 to the fourth. If for any reason your 
terminal is turned OFF, your function keys will be cleared and 
you must run the KEYS program again. Rebooting the system does 
not by itself require you to run the KEYS program again unless 
your terminal was turned OFF in the process. 
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Using Special Ruction Keys on a TeleVideo 925 

If you have a TeleVideo 925 and you want to use use keys Fl 
and F2 to switch to the first and second VT screens, your system 
manager must set up the VTTYS file accordingly. It does no good 
to run the KEYS program on a TeleVideo 925 since that terminal's 
function keys are "hard wired" to send special character 
sequences, and these keys cannot he reprogrammed. Note that a 
TeleVideo 925 can only support two VT screens. 

If your TeleVideo 925 uses keys Fl and F2 to switch screens, 
you will notice When you type Control A (~A), as you may do When 
running WordStar, there will he no response until you type a 
subsequent key. Then both the Control A and the subsequent key 
will be executed. This is because the function keys cn a 925 
always send a Control A, which consequently must be selected as 
your leadin character if you want to use them. 
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INTRODUCTION TO SECTION 3 

SECTION 3 provides detailed instructions on the operation of 
the KEYS program, a utility Which makes it easy to program the 
special function keys of any terminal that emulates a TeleVideo 
950. These terminals include the TeleVideo 950, the Freedom 200, 
and the GCS-80. This section describes the structure of KEY 
template files, shows how to create template files, and explains 
some of their limitations. A Function Key Symbol Table for the 
TeleVideo 950 is also documented in this section. Function Key 
Symbol Tables for the Freedom 200 and GCS-80 terminals can be 
found in APPENDIX A. APPENDIX A also provides sample KEYS files 
for the TeleVideo 950, Freedom 200, and GCS-80 terminals. 
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3.1 THE PURPOSE OF THE KEtfS PROGRAM 

The KEYS program makes it convenient to program the 
special function keys of the Tele Video 950, the Freedom 200, the 
GCS-80, and any other terminal whose function keys use Tele Video 
950 protocol. The KEYS program uses special template files that 
you can create with any ASCII text editor such as WordStar in 
non-document mode. You can create as many different template 
files as you wish, and so you can develop a whole library of 
function key definitions to suit various projects. To assign a 
template file to the function keys of your terminal, you simply 
execute the KEYS program by entering a line of the following 
form: 


QA>KEYS template 


where template is the name of a file whose file type is -KEY. 
Thus, to use a template file called SAMPLEJ<EY to program your 
terminal's function keys, you must type: 


QA>KEYS SAMPLE 


3.2 THE STRUCTURE OF TEMPLATE FITES 

Template files have a simple structure. A template file 
consists of a series of lines, each one dedicated to a specified 
function key. The first character in the line, called the key 
symbol, represents the key to be programmed, and the remaining 
characters, the text, represent the characters which the 
associated key should send whenever it is pressed. These 
template files must have a file name of no more than eight (8) 
characters, and must have .KEY as the file extension. For 
example, a file of key assignments for Super Calc might be named 
9C.KEY, while a file of key assignments for dBASE II might be 
called DBASE.KEY. 
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To assign the definitions contained in a file called 
DBASE .KEY to the 18-key pad, type: 

QA>KEfS DBASE 

To reassign these keys according to a file called SC.KEY, 

type: 

QA>KEYS sc 

If KEYS.CMD is assigned STS and RD status hy the command: 

QA>SET KETS.CMD[STS,BO] 

a copy of KEYS.CMD in user area 0 can he invoked hy all user 
areas of a logical drive. 
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3.3 USING WORDSTAR TO CREATE A TEMPLATE FILE 

To create a template file, use WordStar to create a file in 
the non-document mode (i.e., from the "OPENING MENU" enter (N) 
rather than (D)). Give your file any name that you wish, but 
make sure that its extension is .KEY. For example, you could 
call a file TEST .KEY, but don't call it TEST.TRY. 

Your file can have as many lines as you have logical 
function keys to program. For the Tele Video 950 and the Freedom 
200, a single key can send one message unshifted and a different 
message shifted, so in effect you have twice as many logical 
function keys as physical ones. The first character in each line 
must contain the symbol for the key that you wish to program. 

The actual symbol used to specify a function key is not dictated 
by the KEYS program, but is dependent on the terminal itself and 
should be defined in the user's manual for that terminal. The 
rest of the line can contain characters representing the data to 
be transmitted by the specified key. 

3.4 EDiTEKEKHS ON THE NUMBER OF CHARACTERS THAT CAN BE PROGRAMMED 

The characters which each function key is to send sure not 
stored in the main memory of your computer, but in the internal 
memory of the terminal itself. Since this internal storage 
capacity is in all cases quite limited, you are restricted as to 
the number of characters you can assign to each function key and 
to each terminal. For example, the Tele Video 950 allows up to 63 
characters per function key and up to 256 characters total. The 
Function Keys Symbol Tables on the pages that follow and in 
APPENDIX A indicate for each terminal the maximum number of 
characters that are allowed per function key (corresponding to a 
line in the template file) and the maximum number of characters 
allowed per terminal (corresponding to the entire template file). 
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3.5 HSCTKXf KEY SYMBOL TABUS 

The FUNCTION KEY SYMBOL TABUS FOR THE TELEVIDED 950 shows 
the special symbols assigned to each key of the 950 terminal. 
Additional tables in the Appendix show the symbols used to 
represent programmable function keys on the Freedom 200 and the 
GCS-80 terminals. The TeleVideo 925 has no table, because it 
does not support programmable keys. If you have a terminal that 
supports TeleVideo 950 protocols but that is not included in 
these tables, you should be able to find the appropriate symbols 
by examining the documentation of the terminal in question. The 
symbols themselves are typically referred to in documentation as 
"pi values." 
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3.6 RUCTION KEY SYMBOL TABLE FOR THE TELEV3DED 950 


Thble 3: function Key Symbols for the TeleVideo 950 

Maximum characters per key: 63 
Maximum total characters: 256 


KEY TO BE PROGRAMMED 

FI (Unshifted) 
F2 (Uhshifted) 
F3 (Unshifted) 
F4 (Unshifted) 
F5 (Uhshifted) 
F6 (Unshifted) 
F7 (Uhshifted) 
F8 (Uhshifted) 
F9 (Unshifted) 
F10 (Uhshifted) 
Fll (Uhshifted) 
FI (Shifted) 

F2 (Shifted) 

F3 (Shifted) 

F4 (Shifted) 

F5 (Shifted) 

F6 (Shifted) 

F7 (Shifted) 

F8 (Shifted) 

F9 (Shifted) 

F10 (Shifted) 

Fll (Shifted) 


SYMBOL IN TEMPLATE FILE 


1 

2 

3 

4 

5 

6 

7 

8 
9 


< 

> 

? 

@ 

A 

B 

C 

D 

E 

F 


To program the F4 key on a TeleVideo 950 or Freedom 200 to 
send the message: "THIS IS A TEST," your template file should 
have the following entry: 

4THIS IS A TEST 


40 



SECTION THREE: THE KEYS PROGRAM 


The numeral 4 in the first column tells the KEYS program to 
program the F4 key, and the rest of the line tells the KEYS 
program the sequence of characters that the F4 key should send. 
If you create a template file containing the above line and call 
it F4TEST.KEY, you can use it to program the F4 key by typing: 


QA>KEYS F4TEST 


After running the above program, your F4 key should cause 
the terminal to display: 


QA>THIS IS A TEST 


Any combination of programmable keys can be designated in 
your template file, and key symbols may appear in any order. 
Executing the KEYS program will program only those keys specified 
in the template file, and will leave all other keys as they were. 
If a key symbol in a .KEY file is followed only by a caret (~), 
the designated key will be disabled When the KEYS program is run. 

3.7 OON1RQL CHARACTERS 

TO send control characters, each control character in the 
template file should be preceded by a caret (*). For example, to 
program the F2 key to send a control C, your template file should 
have the following entry: 

2~C 


The 2 in the first column specifies the F2 key, and the 
caret (~) character tells the KEYS program that the character to 
follow, the letter C, should be converted to a Control character. 
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Or, if you want to program the key labeled Insert Character 
on the Freedom 200 as a leadin character, type: 

A @ 


The A in the first column indicates that the subsequent 
character, the @ symbol in the template file, should be converted 
to a Control character. 

An exception to the use of the caret ( A ) character occurs 
when you want to use the KEYS program to send the caret (~) 
character itself. This is accomplished by putting two 
consecutive caret ( AA ) characters into the KEYS file. See 
Section 3.8 below for instructions on how to send a Control caret 

n. 


3.8 SPECIAL CASES FOR CONTROL CHARACTERS: 

CONTROL A (CARET), CONTROL Y, AND CONTROL UNDERSCORE! 

( ) 


Certain control characters require special consideration: 
CONTROL A (caret) 

Since AA sends the caret character rather than a Control 
(caret), you should use A > to send a Control A (caret). This 
will work because a Control A (caret) and a Control > (sign for 
greater than) both equal the same byte (IE Hexadecimal). 

CONTROL Y 

To program a Control Y into the text field of a KEYS file, 
you must use ^P'Y and not just the *Y. The reason that A P must 
precede the *Y is that the Freedom 200 and TeleVideo 950 
interprets 'Y to mean "end of text." So if you want to program 
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your Delete Character (shifted) key to send the message, "This is 
a test,” and you type the following string in a WordStar non- 
document file with .KEY as the file type: 

"QTHIS ~YIS A TEST 

the Freedom 200 and TeleVideo 950 interprets the *Y to mean "end 
of text,” and so will not recognize the text string that follows, 
lb prevent this from happening, you must embed a ~P immediately 
before the *Y. This tells the Freedom 200 or TeleVideo 
950 that the character immediately following the A P should be 
interpreted literally. So if you type: 


"OMIS P^Y IS A TEST 


the Freedom 200 will recognize the ~Y as simply ~Y, and not as 
"aid of text." 

Please note that in the template file key symbol field of 
the KEYS file, it is all right to indicate a Control Y with a *Y. 
So if you want to program your Scroll Down (shifted) key to send 
the message '"Ibis is a test," you must type: 


<s YTHIS IS A TEST 


CONTROL UNDERSCORE (~_) 

The last entry to be wary of when using the KEYS program is the 
Cursor Down (shifted) key, represented by Control Underscore (*_) 
in the template file. The symbol is the default leadin 
character far the Virtual Terminals program. The Virtual 
Terminals program assumes that if a 0,1,2, or 3 follow a Control 
Underscore (*_), that you intend to switch to another Virtual 
Terminals screen. For example, if A _2 is typed, you will have 
just instructed Virtual Terminals to switch to Virtual Terminal 
screen #2. To avoid this confusion, make sure that if you’re 
going to program the Cursor Down (shifted) key, don't use 0,1,2, 
or 3 at the beginning of the text string. 
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3.9 INCLUDING OR SUPPRESSING CARRIAGE RETURNS 

If you want a programmable key to include a carriage return 
at the aid of your data string, just end the corresponding line 
in the definition file with a carriage return. If you want a 
carriage return to occur in the middle of a line of text, insert 
a Control M ("M) at the desired location. If you do not want your 
data string to end with a carriage return, end the corresponding 
line with the caret ("). For example, to cause the F7 key on a 
TeleVideo 950 or Freedom 200 to send the message: "I CAN NAME THAT 
TONE IN," your definition file should have the following entry: 


71 CAN NAME THAT TONE IN" 


Hie numeral 7 in the first column tells the KEYS program to 
program key F7. The caret (") tells the KEYS program not to add 
a carriage return to the data string sent by the F7 key. 

3.10 COUNTING CHARACTERS 

In counting programmed characters to determine Whether they 
exceed the maximum number permitted on a given terminal, the 
following rules apply: 

A carriage return counts as a character, so any line in your 
definition file that does not terminate with a caret (") should 
only have twenty-five (25) data characters, for the GCS-80, 255 
characters for the Freedom 200, and 63 for the TeleVideo 950. 

The caret (") itself does not count as a character. 
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Table 4: Function Key Syabol Table for the Freedcai 200 
Maximum characters per key: 256 
Maximim total characters: 256 

REST TO BE PROGRAMED I SYMBOL IN TEMPLATE FILE 


FI 

(Unshifted) 

1 

1 

F2 

(Uishifted) 

1 

2 

F3 

(Unshifted) 

1 

3 

F4 

(Uhshifted) 

1 

4 

F5 

(Unshifted) 

1 

5 

F6 

(Unshifted) 

1 

6 

F7 

(Uhshifted) 

1 

7 

F8 

(Unshifted) 

1 

8 

F9 

(Uhshifted) 

1 

9 

F10 

(Uhshifted) 

1 

• 

• 

Insert Mode 

(Uhshifted) 

1 

• 

$ 

Insert Char 

(Uhshifted) 

1 


Delete Char 

(Uhshifted) 

1 


Insert Line 

(Uhshifted) 

1 

~B 

Delete line 

(Uhshifted) 

1 

~C 

Erase EDL 

(Uhshifted) 

1 

*D 

Erase BOP 

(Uhshifted) 

1 

"E 

Send 

(Uhshifted) 

1 

~F 

Print 

(Uhshifted) 

1 

*G 

Scroll Up 

(Uhshifted) 

1 


Scroll Down 

(Uhshifted) 

1 

"I 

Word Left 

(Uhshifted) 

1 


Word Right 

(Uhshifted) 

1 


Cursor Up 

(Uhshifted) 

1 


Cursor Down 

(Uhshifted) 

1 

*0 

Cursor Left 

(Unshifted) 

1 

space 

Cursor Right 

(Unshifted) 

1 

1 

Clear/Home 

(Uhshifted) 

1 

*L 

Tab/Back Tab (Unshifted) 

1 

V 

Return 

(Unshifted) 

1 

*M 

Back Space 

(Uhshifted) 

1 

Z 


(continued on following page) 
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table 4: Function Key Syabol Table for the Freedom 200 (aantinued) 


KEY TO 

BE PROGRAMED 

Line Feed 

(Unshifted) 

Enter 

(Uhshifted) 

i 

(Unshifted) 

- 

(Uhshifted) 

Point 

(Unshifted) 

0 

(Uhshifted) 

1 

(Unshifted) 

2 

(Uhshifted) 

3 

(Uhshifted) 

4 

(Uhshifted) 

5 

(Unshifted) 

6 

(Uhshifted) 

7 

(Unshifted) 

8 

(Uhshifted) 

9 

(Uhshifted) 

00 

(Uhshifted) 

FI 

(Shifted) 

F2 

(Shifted) 

F3 

(Shifted) 

F4 

(Shifted) 

F5 

(Shifted) 

F6 

(Shifted) 

F7 

(Shifted) 

F8 

(Shifted) 

F9 

(Shifted) 

F10 

(Shifted) 

Insert Mode 

(Shifted) 

Insert Char 

(Shifted) 

Delete Char 

(Shifted) 

Insert Line 

(Shifted) 


SYMBOL IN TEMPLATE FILE 


\ 

X 

T 

R 

P 

# 

% 

I 

) 

+ 

7 

H 

J 

L 

N 

< 

> 

? 

@ 

A 

B 

C 

D 

E 

F 

*P 

"Q 

"R 


(aantinued on following page) 


46 




APPENDIX A 


Table 4:Fimction Key Syabol Table for the Freedon 200 (continued) 


KEY TO BE PROGRAMMED 


Delete Line 

(Shifted) 

Erase EOL 

(Shifted) 

Erase EDP 

(Shifted) 

Send 

(Shifted) 

Print 

(Shifted) 

Scroll Up 

(Shifted) 

Scroll Down 

(Shifted) * 

Word Left 

(Shifted) 

Word Right 

(Shifted) 

Cursor Up 

(Shifted) * 

Cursor Down 

(Shifted) * 

Cursor Left 

(Shifted) 

Cursor Right 

(Shifted) 

Clear/Home 

(Shifted) 

Tab/Back Tab 

(Shifted) 

Return 

(Shifted) 

Back Space 

(Shifted) 

Line Feed 

(Shifted) 

Ehter 

(Shifted) 

/ 

(Shifted) 

- 

(Shifted) 

Point 

(Shifted) 

0 

(Shifted) 

1 

(Shifted) 

2 

(Shifted) 

3 

(Shifted) 

4 

(Shifted) 

5 

(Shifted) 

6 

(Shifted) 

7 

(Shifted) 

8 

(Shifted) 

9 

(Shifted) 

00 

(Shifted) 


SYMBOL IN TEMPLATE PILE 


"S 

"T 

"V 

*Y 

A C 

A _ (underscore) 

0 (zero) 

II 

W 

n 

c 

] 

Y 

U 

5 
Q 
$ 

6 

( 

* 

' (apostrophe) 

• 

G 

I 

K 

M 

O (upper case letter O) 


* Special case—refer to Section 3.8. 
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Table 5:Ftuction Key Symbol table far QCS-80 

Maximum characters per key: 26 
Maximum total characters: 468 


KEY TO BE PROGRAMMED 
18-key pad only 


SYMBOL IN TEMPLATE FILE 


00L MODE 


1 

( 

COPY BLOCK 

1 

) 

WRITE BLOCK 

1 

* 

BLOCK DEL 


1 

+ 

Hyphen key 

1 

- 

Gemma key 


1 

9 

ENTER 


1 

/ 

Decimal point 

1 

• 

Zero 

(0) 

1 

0 

One 

(1) 

1 

1 

TVo 

(2) 

1 

2 

Three 

(3) 

1 

3 

Pour 

(4) 

1 

4 

Five 

(5) 

1 

5 

Six 

(6) 

1 

6 

Seven 

(7) 

1 

7 

Eight 

(8) 

1 

8 

Nine 

(9) 

1 

9 


Remember that when creating a template file on the GCS-80, 
you should use the main keyboard rather than the 18 key-pad to 
the right of the main keyboard, since this pad may already be 
reprogrammed, and so may not put the proper character in column 
one (1) of your file. See Gifford's GCS-80 USER'S MANUAL for 
more information on programming the GCS-80 keys. 
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Sample KEfS File for TeleVLdeo 950/Freedom 200 

For the TeleVideo 950 and Freedom 200 terminals, the 
VT950.KEY file has been included on your master system diskette. 
This is written to program function keys one (1) through four (4) 
to switch directly to the first through fourth VT screens, 
respectively. To program these function keys, simply type: 


GA>KE2f5 VT950 


If for any reason you need to re-create this KEfS assignment 
file, follow the instructions below: 

1. In the WordStar OPENING MENU, type (N) for non-document. 

2. Enter a file name far your key assignment file. 

Example: VT950.KEY 

3. In the non-document file, type the character of the key that 
you wish to reprogram, followed by your leadin character, as 
specified in field 8 of your VTIYS file, and then the number 
of the destination VT screen. 

4. The VT950.KEY file should contain the following lines of 
text: 

i~_cr 

3 ^~ 2 ~ 

4~_3~ 

In the example above, the first numeral in each line 
represents the number of the function key that you intend to 
program to switch to a specified VT screen. The control 
underscore (~_) characters represent the leadin character 
that the VT program uses to tell the computer that the 
subsequent character is the number of the destination VT 
screen. The numeral following the leadin character is the 
number of the destination VT screen. The last character, a 
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caret (~), signifies that you do not want a carriage return 
embedded at the end of each line. 

5. When you have completed your new key assignments, save the 
non-document file and exit from WordStar. 

6. Now type KEYS VT950 and the FI, F2, F3 and F4 keys on your 
terminal will now switch to VT screens 0, 1, 2, and 3, 
respectively. 
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Sample KEYS File far GCS-80 

Ebr the QCS-80 terminal, the VPGCS80.KEY file has been 
included on your master system diskette. This is written to 
program the CDL MDDE, CDFY BLOCK, WRITE BLOCK and BLOCK DELETE 
keys to switch to VT screens 0, 1, 2, and 3, respectively. To 
program these function keys, simply type: 


QA>KEYS VTGCS80 


If for any reason, you need to re-create this KEYS 

assignment file, follow the instructions below: 

1. In the WordStar OPENING MENU, type (N) for non-document. 

2. Enter a file name far your key assignment file. 

Example: VTGCS80.KEY 

3. In the non-document file, type the character that corresponds 
to the key that you wish to reprogram, followed by your 
leadin character, as specified in field 8 of your VTTYS file, 
and then the number of the destination VT screen. 

4. The VTGCS80.KEY file should contain the following lines of 
text: 

r 0" 
r~r 
*~~ 2 ~ 

+~~ 3 ~ 

m the example above, the special symbol at the beginning of 
each line represents the key to be programmed, according to 
the Function Key Symbol Table on page 49. The control 
underscore ( A _) characters represent the leadin character 
that the VT program uses to tell the computer that the 
subsequent character is the number of the destination VT 
screen. The numeral following the leadin character is the 
number of the destination VT screen. The last character, a 
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caret (*), signifies that you do not want a carriage return 
embedded at the end of each line. 

5. When you have completed your new key assignments, save the 
non-document file and exit from WordStar. 

6. NOW type KEYS VTGCS80 and the ODL MODE, COPY BLOCK, WRITE 
BLOCK, and BLOCK DELETE keys on your terminal will now switch 
to VT screens 0, 1, 2, and 3, respectively. 
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VT BOB REPORT 


This form should be used to report problems with the 
Virtual Terminals software or with this manual to Gifford 
Computer Systems. Every report will be reviewed by our 
Customer Support Department. 


Date: 


Name:_ 

Company/Organization:_ 

Address:_ 

City, State, Zipcode:_ 

Telephone:_ 

MC-DOS System Number:_ 

MC-DOS Release Version:_ 

State the exact problem and symptoms that you encountered with 
Virtual Terminals or KEYS below: 
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A 

Absolute (“logical) terminal number, 8,13 
Additional screens, 5,7, 

Arbitrary screen switch, 14,16,18 
ASCII equivalents, 17,18 

Asterisk (*) in WHO for attached screens, 30 

B 

Background processes, i,9,23,2431 
Boot sequence, 7,11 
BUFFERED output, 9,22,23 
Buffers, disk, 23,24 
Bug report, 53 

C 

Caret C) symbol for CONTROL key, ii 
in KEYS template files, 41,51 
in VTTYS command strings, 14-19,21,26 
Carriage return (=CR): 

in KEYS template files, 41-43,45-52 
in VTTYS command strings, 20-21, 
in screen switch command sequences, 33,34 
CCPMINIT.CMD, 3 

Character sequences, 4,20,32,33 
Clear screen, 14-18 
Command arguments, 22 
Command strings, 13-19 
Compatible terminals, i,2 
Concurrent CP/M, i 
CONSOLE command, 8 

Control characters, ii, 14-16,18,21,32-33,41-59 
Converting to hexadecimal, 8,11,14,42 
Copyright notice, [flyleaf] 

Counting characters, 44 
CP/M 2.2 and CP/M-86, i 
Cursor movement, 43,45,47 
Customizing the PASSWD file, 1 
Customizing your VT program, 1,7 
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D 

Default leadin character, 31,43 
Default output mode, 23 
Default values: 

for VCMODE OUTPUT, 9,22 
for leadin character, 40 
Delay, 7,8,18 

Disabling the Status Line, 15,17,19 
Disclaimer, [flyleaf] 

Downward screen switch, 12,14,18,20 
Dynamic memory allocation, 15 
DYNAMIC output, 24 

E 

Embedding carriage returns, 44,50,52 
Enabling the Status Line, 15,17,19,21-23,38 
Escape sequences, 7,8,12-13,14,18 
Extended I/O System (XIOS), 3,4,5-7 

F 

Fields, 17,10,12 

Fixed function keys of TeleVideo 925, 16,21 
Floppy diskette, 3-5,13,25,49,51 

Freedom 200, [flyleaf],2-5,6,10-14,25,31,32-33,35-36,39-40,42-47 
Function key programming limitations, 17,16,21,26,34,38 
Function key symbol tables, 40,45-48 

Function keys, i,3,4,11,16,21,25,26,32-34,36,38-39,49,51 
G 

GCS-80, i,2-5,10,12-13,18-19,25,35,36,39,44,48,51 
GCS-80 USER'S MANUAL, 48 
GENOCPM, 3,11 
Getting started, 29 

Gifford Computer Systems, [flyleaf],ii,3,10,14,16,18,53 
Guide to the Manual, ii 
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H 

HELP option of VCMODE, 22 
Hexadecimal conversion, 8,11,14,42 

I 

Initialization, 3,7,11,14,16,18 
Installing VT, 1-27 
Introduction, i 

K 

Kernel, 4,20, 

KEYS utility program, ii,1,3,4,25,26,32-33,34,35-39,41-44 
KEYS tenplate files, 4,25,32,35-48 

L 

Leadin character, 8,11,16,20,21,26,31,34,42,49,51 

Limitations on function key programming, 35,38 

Line feed, 8,46,47 

Loading the Status Line, 15,17,19 

Logical (="Absolute") terminal number, 8,13 

Logout, 31 

N 

Manual references, ii,3,27,48 
Master diskette, 3-5,13,25,49,51 
Maximum memory pages, 2,5 
MC-DOS [see Multiuser Concurrent DOS] 

Memory requirements, 2 
Monitored screens, 26,30 
MP/M 8-16, ii 
MP/M-86, i,ii 
MP/M II, i,ii 
Multitasking, ii 
Multiuser, ii 

Multiuser Concurrent DOS, i,ii,iii,2-4,8,20,30,53 
Multiuser Concurrent DOS system diskette, 3,4 
Multiuser Concurrent DOS XIOS disk, 3,5 
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N 

Name: prompt/ 29/30 

Non-document node (WordStar), 7,13,25/36/38,49/51 
Null character, 8 

Number of memory pages, 2,5,10,14-19,32-33 
Number of physical terminals, 5 
Number of system printers, 6 
Number of VT screens, 2,4-6,11,29,34 

O 

Operating system, i,2,20 
Operation of VT, 1,20 
Output mode, 23 
Output to printers, 28 
Overview of installation, 4 

P 

Pages of memory, [see Number of pages] 

Passwords, 29 

PASSWD file customization, 1 
Physical terminals, 5-7,,9,10, 

Physical terminal number, 8,10, 

PIP command, 4 
Printers, number of, 6 

Program disk, [see System master diskettes] 
Program files, 3,4 

Programmable function keys, 3,4,11,25,32,38-52 
Programming function keys, 3,25,33,36-52 

Q 

Qume CVT 108 terminal, i,2,5,6 
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R 

RAM, 2„6,23,33 
Requirements, 

Memory, 2, 

System, 2 
Terminal, 2 

Reserved for future use (RFU), 10,14,16,18 
Reverse video, 15,17 

S 

Sample command strings, 14-19 

Sample KEYS files, 3,49,51 

Sample terminal configuration, 6 

Sanple VTTYS file (VTPYS.SAM), 3,4,14,16,18 

Screen buffers, 5 

Screen memory, 2,5,6 

Screen pages, 6,7 

Screen output, 3,9,23,24 

Screen scroll 9 

Screen switch! 7,11,12,14,16,20,25,26,30-34,49,51 
Selecting a leadin character, 11,31,34 
Selecting a VT.RSP, 3,5,6 
Sixteen VTTYS fields, 10-13, 14-19 
Slash (/) character, 7 
Software, VT, 3,4,7,22,25 
Special cases for control characters, 42,43 
Control * (caret), 42 
Control Y, 42 

Control _ (underscore), 43 
Special Codes for VTTYS file, 7-9 
Special function keys, i,3,4,21,25,26,30,33,34,36-51 
Status Line, 8,9,13-19,29,30 
Status of: 

command arguments, 37 
VCMODE, 22-24 

String (Command), 7,13,14,16,18,43,44 
Structure of template files, 36 
Stylistic conventions, ii 
Suppressing carriage returns, 44 
Switching VT screens, 12,14,16,31-33 
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System commands, ii 

System generation, [see GENOCPM] 

System manager, ii,27,29,30,34 

System master diskettes, 3,4,5,13,25,49,51 

System pronpts, ii 

System requirements, 2 

System screens, [see system consoles] 

T 

TeleVideo: 

925, i,2,5,6,10-13,16,17,21,30,32,34, 

950, i,2,5,6,10,12-15,25,30,32,33,35,36,38,40,42-44,49 
Template file structure, 3,4,25,26,32,33,36,39-43,48 
Terminal initialization, 3,7,11,14,16,18 
Terminal requirements, 2 
Tick delay, 7 

Trademark notices, [flyleaf] 

TTYS file, 4,6,8,10,13,14,16,18 

O 

Underscore, 11,14,21,26,30-32,42,43,47,49 
Upward screen switch, 12,14,16,18,20 
USERINIT.SUB, 26 
User's Guide to the Manual, ii 

Using WordStar for KEYS program, 4,13,25,36,38,43,51,52 

V 

Virtual terminal (=screen) number, 17,31,32,49,51 

VIRTUAL TERMINAL RSPs disk, 3-6 

VT bug report, 53 

VT environment, 28,31 

VT kernel, 4,20 

VTQCS80.KEY, 3,25,33,51,52 
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